PrestaShop Cookies (compatible with Google Consent Mode 2.0)

PrestaShop Cookies Documentation

Table of contents

1. Introduction
2. Installation
3. License activation
4. Management panel
5. Cookie management
6. Managing groups of cookies
7. Appearance configuration
8. Integration with Google Consent Mode
9. Using the module in templates
10. Troubleshooting
11. FAQ

1. introduction

• Automatic detection of cookies used in the store
• Grouping cookies by category
• Blocking cookies that you have not consented to
• Customizable consent banner with different styles
• Full integration with Google Consent Mode 2.0
• Compliance with RODO and ePrivacy requirements
• Multilingualism support
• Advanced API for use in templates

2 Installation

• PrestaShop 1.7 or later
• PHP 7.0 or later
• Permission to install modules

1. Download the ZIP file of the module from the official store cocos.codes
2. Log in to your PrestaShop admin panel
3. Go to: Modules > Module Manager > Add New Module
4. Click "Add Module" and select the downloaded ZIP file
5. When the installation is complete, click "Configure"

3. license activation

1. After installation, go to configure the module
2. Select the "License" tab
3. Enter the license key you received after purchase
4. Click "Activate License"
5. After successful activation, you will see a confirmation message and all functions of the module will be unlocked

4. management panel

• Cookies - managing detected cookies
• Groups - managing groups of cookies
• Configuration - general settings of the module and banner appearance
• Google Consent Mode - Google Consent Mode 2.0 integration configuration
• Handbook - instructions and examples of use
• Plugins - additional extensions for the module
• License - module license management

• Turning the module on/off
• Automatic cookie detection
• Set the default group for newly detected cookies
• Hiding the banner from robots (bots)
• Refresh page after changing cookie preferences
• Managing consent revisions (forcing the banner to be shown again)

5. cookie management

• Cookie name
• Domain
• Assigned group
• Status (active/blocked)
• Date added
• Available actions

1. Click the "Add New Cookie" or "Edit" button next to an existing one
2. Fill out the cookie data form:
   • Name of cookie - unique cookie name
   • Domain - the domain for which the cookie is stored
   • Track - cookie path (default "/")
   • Group - Assignment to a group of cookies (e.g., essential, analytical, marketing)
   • Description - description of the function of the cookie visible to users
   • Status - active or blocked
3. Click "Save" to save the changes

• Detects new cookies while browsing the site
• Automatically assigns them to the appropriate groups based on a built-in database of cookie names
• Adds default description for recognized cookies
• Assigns unrecognized cookies to the "Uncategorized" group.

6. cookie group management

• Necessary (strictly_necessary) - cookies necessary for the operation of the site
• Functional - cookies that allow personalization of functions
• Statistical/Analytical (performance) - cookies that collect traffic information
• Marketing (marketing) - cookies used for advertising and profiling
• Unclassified - cookies not yet assigned to a category

• Add, edit and delete groups (except default ones)
• Set group mandatory (groups marked as required cannot be rejected by the user)
• Set group activity status
• Changing the display order of groups in the banner
• Managing translations of group names and descriptions

7. appearance configuration

• Message title (with multilingual support)
• Message content (with support for multilingualism)
• Banner style (bar, window, cloud)
• Horizontal position (left, center, right)
• Vertical position (top, middle, bottom)

• Maximum width
• Rounding the corners
• Shadow
• Background color
• Text color
• Button colors (background and text) for "Accept all", "Accept selected" and "Reject all"
• Custom CSS

• Mini-banner position (left/right side)
• Distance from bottom of page
• Mini-banner size
• Shape (round, rounded, square)
• Background color
• Icon type (Material Icon, predefined images, custom URL)
• Icon color
• Hover effect (zoom, rotate, none)

8 Integration with Google Consent Mode

• Enabling/disabling Google Consent Mode
• Setting whether the Google Tag code is already installed in the store
• Google Tag ID entry (for Google Analytics 4 or Google Tag Manager).

• URL Passthrough - passing campaign parameters via URL.
• Ads data editing - removing conversion information in the absence of consent
• Waiting time (ms) - the delay before Google Tags is launched

• Assign Google consent types to each group of cookies
• Available consent types:
  • Ad storage (ad_storage)
  • Ads user data (ad_user_data)
  • Ad personalization (ad_personalization)
  • Analytics storage (analytics_storage)
  • Functionality storage (functionality_storage)
  • Personalization storage (personalization_storage)
  • Security storage (security_storage)

9. use of module in templates

{if {cc_ps_cookies_has_consent group='functional'}}
    <div class="alert alert-success">Your consent for functional cookies has been given!</div>
{else}
    <div class="alert alert-warning">No consent for functional cookies.</div>
{/if}

{hook h='displayCcPsCookiesButton'}.

{hook h='displayCcPsCookiesButton' class="btn btn-primary btn-sm" text="Privacy settings" icon="lock"}

// Checking for cookie group consent
if (window.ccPsCoookieConsent && typeof window.ccPsCoookieConsent.hasConsent === 'function') {
    if (window.ccPsCoookieConsent.hasConsent('performance')) {
        console.log('Consent for analytical cookies has been given!');
        // Here you can initialize, for example, Google Analytics
    }
}
// Listening for the cookie preference change event
document.addEventListener('cc_ps_cookies_preferences_changed', function(event) {
if (event?.detail?.preferences) {
console.log('The cookie preferences have been changed:', event.detail.preferences);
}
});

10. troubleshooting

1. Check if the module is enabled in the "Configuration" tab.
2. Make sure the license is active
3. Make sure the displayFooter hook is registered and working properly
4. Check that you do not have "Hide from bots" enabled and that your browser is not identified as a bot
5. Check if the user has not already saved cookie preferences - increase the revision number to force a redisplay

1. Make sure automatic cookie detection is enabled
2. Check that cookies are assigned to the right groups
3. Make sure the cookie-blocker.js script is loaded correctly
4. Check whether the site uses a custom cookie setting mechanism that bypasses the standard document.cookie function

1. Make sure Google Consent Mode is enabled
2. Check if the Google Tag ID is correct (for G-XXXXXXXXXX) or if the Google Tag code is already installed
3. Make sure the mapping of cookie groups to Google categories is properly configured
4. Check if the google-consent-mode.js script is loaded correctly

11 FAQS.